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BOGS: "Eh # what’s up Doc?" 

r> 

FUDD: "You’we a shwewd chawactew Mistew Wabbit, 

I*we get you now!" 


The Fudd i an Dialogu es, page vi. 
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for lit BUGS C °Iultiprocessing * ^ystlV^r debUgyer 

issriSiziy.srz tirth- B 3 -V ™ ~;:ss*£ 

the disk, whenever an undefined iite^rn^ 1 " F ° rtl °" o£ F “»° is on 
fetches the win pottiofS FatSS tE C “J'' k “ , / 00t ■‘>‘"■ 1 ® 

erecntion. FOOD gives the user m,. ,??•.?£* ils * anii starts its 

the five different storage types available* t0 d i splay and store 
control erecution of his prograa. ai * able on the systen and to 

the user ^MeL^o^ail^oragrii!! 1 ®! 9Ua9e ls ta iioied to alio, 
contains tso distinct '•»““ 

(appropriate to a simplex oDera+ii„» . CPU U ' th ori 9 i« system 
useful parts have been kS 1 I has been scrapped, but the 
addresses and lengths and a nrA .r £xpressions ma y be used for 
program uithoutneeding a nSZri?* 9 ** Sit down to debu * his 
etc. by hand. That is after all ° sabtract and add addresses 
good at. ' after a11 ' " bat computers (usually) are 

«P to sixteen break pcinS andy£i v 1A °*' he USer to ba?e 
given time. it is flS nr ^ heck P ° Xnts activ « a t any 

checkpoints in his proqram P so i-ha^ f °k the User to include 
■ odify values during P exLution h ?L f ®,? 1 sh ®. can display or 
core storage lijaits) of gns I™* 1 £u11 capabilities (within 

the control of FUDD. Some of the** gSs^cm* " hile UDder 

directly (QOERX, MODHAP inSLn no ? S ands are available 

rest may be accessed through the g ns command. *** aPDZAP) and the 

i * . • • 


*Marne courtesy of Susan Beckley. 
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? COMMAND SYN TAX 


The commands consist of a command name, which may be 
abbreviated, followed by one or more parameters, separated by 
blanks. There are three general types of parameters, the first of 
these types being a literal. Literals are used for label names 
(<label>) and CPU identifiers (<cpu-id>). The only valid 

•<cpu-id>*s are 'A* and • B*. Any character string up to eight 
characters, beginning with an alphabetic followed by letters and 
numbers may be used as a label. 

The second type of parameter is an address (<address>). 
Addresses have both a value and a type. The type is determined by 
the first value in the address string. These types are A-CPU 
register, B-CPU register. Vector General register. Local storage, 
and Main storage. The rules for combination of these storage 
types are not rigorously defined, but seem to be convenient for 

the sort of things which the normal (and even abnormal) user 

might want to do while debugging his program. Any complaints 
about these rules should be written on the walls of the Faunce 
House men’s or ladies* room. 

The A-CPU registers are specified by *R’, *A*, or ’AH’ 

followed by a decimal or hexadecimal number. B-CPU registers are 
specified by *B’ or • BR* followed by a number, and the Vector 
General registers are indicated by ’V* or *VB’ followed by a 
number. Local storage is specified by ’L.* followed by an 
expression. Unless a register is specified first in an 

expression, its contents rather than its number are used in 

computing the final address. 

Both decimal and hexadecimal constants may be used in 

address expressions. Hexadecimal constants ate specified by 

prefixing •/• to the number. The first ncn-valid character is 
treated as the end of the number. The parameter scan continues 
from that point, without demanding an operator. 

Any string not recognizable as one of these types is 
considered to be a label. Labels have three methods of 

definition; first; the external names of all loaded modules are 

automatically entered in the label table; second, upon each entry 
FOOD automatically defines the labels *A' and *B* to the 
beginning of the A-CPU most currently loaded routine, and to the 
start of the current B-CPU procedure respectively; third, labels 
may be added to the label table through the use of the DEFINE or 
TEST commands. Labels and constants always have the type main 
storage, and an address expression starting with these will 
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Sffi53«Sra = =V" ?tas 

“gardUss l? nt i;etLr after / ”“ ber “ lth V* nw^tarMt” 

common extensions may be “bbreJiatdt* " opel:ato,: P«sent, many 

The 'L.* storage designation must always be fi r «t in 
address string, and may not appear in any other conjunction. 

Examples of valid addresses: 

B1 -•> A-CPU register one 
B84 —> B-CPU register four 
A --> address of A-CPU routine 
L »/43 > local storage word X*43* 

til Zll t 0 ™ J a f t the CODt€nts o£ register one 

our bytes past the start of the main »B* procedure. 

... - T ^f of parameter is the length (<lenqth>) or data 

(<data>) type parameter. These may be specified in tit 

JS^-srs sas 
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3 ENTERING FUDD 


r- 


FUDD may be invoiced in many ways, but only two are totally 
under the control of the user. The first of these is to enter the 
FUDD command to GMS. FUDD will respond with the message 'FUDD 
HERE and request a command. The second method, which should 
be used only when the first is not posible, is to depress the 
interrupt key on the 'A* panel. FUDD will respond with the 
message: 

A:I/0 INTERRUPT-(2531)-PANEL AT xxjcx. 


/ “ v Where 'xxxx' is the address of the currently executing routine. 

For debugging routines which use GETMAX, it is advisable to 
^ enter the FUDD command before starting the program. This will 
insure that there will be sufficient core available for FUDD to 
be loaded. 

r*\ 

Once invoked, FUDD will remain in core until the next IPL, 
to allow the user to •. use FUDD during his program test phase, and 
to define global labels which will remain in force until IPL. A 
production program need never compete with the debugger for 
resources, but test sessions should begin with the use of the 
r* FUDD command. If FUDD initialization fails, the machine will 
enter a disabled wait state, with X'FODD* in the upper lights, 
the name of the event which caused entry to.FUDD in the lower 
lights, and the Program Counter set tc the address where the 
event occurred. 
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i_£flDD_COMMANDS 



The FUDD commands are hore divided into five maior aroac 

exeoati“ D1 oo^ro?" C °*T??' -anipulation 

comnand* In oniil aynbolic debugging ccnaands, and systen 
commands. In each section, the commands will be listed in 

vr ^ 


iiil_jDiTA_5ANIPUlATICN_C0flMANDS 


Address operands for DISPLAY 
down to the nearest halfword 
Lengths are always rounded up to 


, STORE, and XF.Efi are rounded 
before the, data is accessed, 
the nearest halfword. 


•DISPLAY* <ADDRESS> [<LENGTH> [<TYPE>]] 


The specified location 
terminal, for the specified 
bytes. The <type> parameter 
which displays the data in 
which displays in decimal; 
translation as well as the 
is specified, the number 
fraction. 


or register is displayed at the 
length. The default length is two 
may take the value *X« (default), 
hexadecimal form; it may be *D*, 
if 'T* is specified, the character 
hexadecimal is printed; and if *F' 
is printed as a signed decimal 


•STORE' <ADDHESS> <DATA> [<DA1A> £<DATA> [<DATA> ]Jj 


specified byte 4ata are placed in the 

one data field i!' and id accending locations if moce than 

specified/dJu.U^dirSL 1 ^. “ P t0 tOUr d * ta fiel4s be 
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'XFER' <ADDRESS-1> <ADDRESS-2> [<LENGTH>] 


Halfwords of data are transfered from <address-2> to 
<address-1> for the length specified (default two bytes). To 
insure against accidental disruption of the data in the 
machine, the maximum length which can be XFER'ed is 256 bytes. 


4.2 P R OG R AM MANIPULA TION COMMANDS 


•DELETE* <MOD(JLE> 

The DELETE command operation is identical to the GMS 
DELETE command. 


•LOAEMOD* <MODULE> 


The LOADMOD conmand operation is identical to the GMS 
ICADMGD command. 


•MAP' <MODULE> [<START>] 


The MAP command is identical to the GMS MODMAP command. 


•ZAP' <HODOL£> £ <CSEC1>] 


The ZAP command is identical to the GMS MODZAP command. 






ilil_ IX ECUT10 N_CCNTfiO I 


• BREAKPT * <ADDRESS> 


r* 


, BREAKPT , <breakpoint-id> * 0 Ff* 

troara^at^+ha^e =™»and causes FUDD to break erscution o£ the 

associated Sun t??« If* aadre r s - A break point identifier is 
noin? Jas h ! aa ^ e * s “>ich is printed after the break 

ide?tifi?d S? e \f‘ et -,u I£ 1°"-' is s P«iiiei- the break point 
identified by the <breakpcmt-id> is removed, when a break 

and ft thi S Bse? eC M? 4 .odifv Pr ? ble " pt ° 9ra “' FUDD “ iJL1 be entered 
,u tne user nay modify storace or his reaisters Tf a hbpik 

" al i «*> is assembled i.Jo’ a n !iU 

act as a check point, allowing the user to display or modify 
data in his program and continue. display or modify 


•CHECKPT 1 <ADDRESS> £<CP0-ID>] 


•CHECKPT* <breakpoint-id> •o.'f* 

default Ch <cDii-?a^ nt m} 1 ? e at tl>e specified address. The 

lliltk* o? ti? tii ? tle '*'• Different instruction 
ngtn*. on the two machines make it neccessarv to specify 

?he? e£?iie? ‘c Prepare for. Although breakpoints are removed 
when executed, checkpoints must be explicitly removed. 

H ints : 

If checkpoints or breakpoints are to be placed on 
seguentialiy executed instructions, they should be specified 
in the order they will be executed. P 

anv oth^o P ?h n J S s ^?“ ld ® ot be Placed on branch instuctions or 

nn Y rA^? ,UOdlfy the P r ° 9 ram counter. Ihey may be placed 

ret£ri L tn r *h A • i nstr ? ctions i± the routine called will always 
return to the intructa.cn following the CALL or BAL. Y 


-7- 






Execution is re-started in both CPU’s, and FUDD goes into 
a dormant state. Execution is continued where it was 
interrupted, unless the user has modified the META 4A*s PC or 
the META 4B*s PBR/PDfi. 


•HALT* <CPU_ID> 


The HALT command causes all execution to halt in the 
specified CPU, except for that neccessary for FUDD to operate. 


’IPL' 


The IPL command causes FUDD to force an Initial Program 
Lead of the system. 


4.4 SYMBOLIC D EBUG GIN G COMMA NDS 


•D£FINE» <LABEL> £<ADCBESS>] 


The DEFINE command allows the user to add, change and 
delete entries in the FUID symbol table. If no value is 
specified for the label, it is deleted. If tne value is 
specified, that is made tha new value of the label, and the 
old value is printed out if any* 


•TEST* <MODULE> ... 


The TEST command may be used to load routines to be 
tested and to define all external labels in those routines in 
the symbol table. If the name(s) given is already defined by 
either being an active program or through use of the DEFINE 
command, the routine will be treated as though it were already 
loaded, and the symbol table value will be used as the 
starting address for resolving the displacements within the 







module (e.y. to define the proper labels for LEVELO, define 
the label LEVELO as being location 0, and then TEST LEVELO). 


•WHERE’ <ADDRESS> [ <TYPE> [<ADDRESS-2>]] 


, The WHERE command is used to display where an address 
lies relative to any other address. The default type is 
relative, which will display *here the address is relative to 
the appropriate module if possible. If ‘A’ is specified for 
the <t.ype>, the absolute value in hexadecimal of the address 
^e printed. If <type> *R' and a second address 
(<address-2>) are specified, the displacement from <address> 
to <address-2> will be printed as a signed hexadecimal value. 


4.5 . SYS TEM CO MMANDS 


'FILEBUG' 


The FILEBUG command catses FUDD to call FILEBUG, the 
Doctor Memory file debugger (vide the Doctor Memory manual for 
details) . 


'GMS' <GMS-COMMAND-STRING> 


The GMS command allow access to any GMS command not 
already defined by FUCD. 'GMS* must merely be appended to the 
GMS command. 


<8HAT> <HQW> 


The operation of the Q command is identical to the GMS 
QUERY command, although most of the operands are more 
meaningful when entered during debugging. 
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5SAHPLE TERMINA L SESSI ON 


The following 
in lower case and 
in brackets. 

> 1 fudd 
FOOD HERE ... 

1 progran 
3C00 

-define a program 
A AT 3C00 

-break a*/10 
BREAK POINT 0000 
-wh a-»/10 
PBOGRAM+/10 
-go 

>prograu 

A:BREAK POINT 0000 
-where rl 
PBOGBAM+/10 
-display r5 2 t 
C2FF <B.> 

-st r5 /c2c2 
-st r6 r5 
-d r5 4 t 

C2C2 C2C2 <BBBB> 
-go 


is a sample session, with the user's entries 
the FUDD responses in upper. Meta—comments are 


£enter PUDD command] 

£ LCACMCD PROGRAM] 

£define label *A*] 

[put break point at A+X»10»] 

£ verify location of break point] 

£ return to GHS ] 

[start program] 

AT 3C10 

[inquire as to location] 

[display R5 in hex and character] 

[store X'C2C2* in R5] 

[put contents of R5 in R6] 

[display R5 and R6 in hex and 
character ] 

[continue execution] 




